home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / PWADTC10.ZIP / DTC.DOC < prev    next >
Text File  |  1995-03-26  |  6KB  |  130 lines
  1.  
  2. +-----------------------------------------------------------------------------+
  3. | Download.TXT Cleaner v1.0                                                   |
  4. | Written by Drew [PWA]                                                       |
  5. | Docs Last Updated 03-26-95                                                  |
  6. +-----------------------------------------------------------------------------+
  7.  
  8.  
  9. +-----------------------------------------------------------------------------+
  10. | 0. Table of Contents                                                        |
  11. +-----------------------------------------------------------------------------+
  12.     1. Introduction
  13.     2. Packaging
  14.     3. Installation
  15.     4. Configuration
  16.     5. General Notes
  17.     6. Last Words
  18.  
  19.  
  20. +-----------------------------------------------------------------------------+
  21. | 1. Introduction                                                             |
  22. +-----------------------------------------------------------------------------+
  23.     This utility will shrink/clean your download.txt file.  It can remove
  24. entries (for):
  25.  
  26.     1. Non-existent files in specified (upload) directories.
  27.     2. .QWK transfers
  28.     3. .CAP (message captures)
  29.     4. Exclude according to specified user names.
  30.  
  31. This is ideal for other utilities which scan the download.txt file for their
  32. purposes (ie: Nukers, Weekly/Monthly bulletin generators, download counters,
  33. etc.).
  34.  
  35.  
  36. +-----------------------------------------------------------------------------+
  37. | 2. Packaging                                                                |
  38. +-----------------------------------------------------------------------------+
  39.     Your zip file should contain the following files:
  40.  
  41.         DTC.EXE        The utility (DOS executable) itself.
  42.         DTC.CFG        Main configuration file.
  43.         DTC.DOC        Documentation (you are reading it now).
  44.         DIRS.CFG       Directories to search for transfered files.
  45.         USERS.CFG      User exclusion file.
  46.         EXAMPLE.BAT    Sample batch file to use.
  47.         HISTORY.DOC    Revision history.
  48.         OTHERDJP.DOC   Other stuff I've written.
  49.         FILE_ID.DIZ    File (zip) description.
  50.         PWA.NFO        PWA info file.
  51.         TSP.NFO        My bbs ad.
  52.  
  53.     If any of these files are missing, be warned that you may have a copy
  54. that has been tampered with.  If you have any extra files, they are extraneous
  55. and unnecessary.
  56.  
  57.     Typically, my bbs ad may not be there, which is not a problem.  However,
  58. the idiots who contribute this to the fidonet backbone (usually originating 
  59. from the Clipper Workshop BBS) edit the FILE_ID.DIZ, remove PWA.NFO and
  60. OTHERDJP.DOC, and insert their own bbs ad which is bigger than most ppe's.
  61. Just be aware, since who knows what other stupidities they may pull.
  62.  
  63.  
  64. +-----------------------------------------------------------------------------+
  65. | 3. Installation                                                             |
  66. +-----------------------------------------------------------------------------+
  67.     It is suggested to put this utility in its own directory.  This is not
  68. mandatory, but it's good for organization. :)
  69.  
  70.  
  71. +-----------------------------------------------------------------------------+
  72. | 4. Configuration                                                            |
  73. +-----------------------------------------------------------------------------+
  74.     Edit DTC.CFG for all options.  It's relatively short and simple, so should
  75. be painless as well.
  76.  
  77.     If you wish to scan multiple directories to remove non-existent files,
  78. make sure you specify the directories in DIRS.CFG, one per-line, and say "yes"
  79. to line 7 in DTC.CFG.
  80.  
  81.     If you wish to exclude transfers made by specific users, put the users's
  82. names in USERS.CFG, one per line, and say "yes" to line 6 in DTC.CFG.
  83.  
  84.  
  85. +-----------------------------------------------------------------------------+
  86. | 5. General Notes                                                            |
  87. +-----------------------------------------------------------------------------+
  88.     I only know of one other program that did anything similar to this.  But
  89. it was a PPE and took *forever* to run.  Hence, I decided to write this up and
  90. have it run as quickly as possible.
  91.  
  92.     This utility does *not* alter the original download.txt file.  This is a
  93. safety precaution so in case something bad happens, you know it's not this
  94. utility's fault. :)  The new output file is specified in the config file, so
  95. you, the sysop, will have to manually rename/delete files.  Basically, the
  96. ideal steps to take after running this utility are:
  97.  
  98.     1. Rename download.txt to download.bak
  99.     2. Rename output.txt to download.txt
  100.  
  101. See EXAMPLE.BAT for exactly what I mean if you do not understand this.
  102.  
  103.     This version is the first non-beta release.  I originally wanted to add
  104. a couple of more features to this (namely, removing entries by arbitrary
  105. filename and/or extension as well as by date), but since there was no real
  106. input on this matter, I've decided to leave it as such.  Hence, this version
  107. is pretty much identical to the last beta release (v0.2) with some code and
  108. compiler optimizations here and there.  Functionally, there should be no
  109. difference.
  110.  
  111.     This utility was written in C and compiled with Borland C++ 3.1.  It has
  112. been tested under a DOS/Desqview environment, but should work with OS/2 as
  113. well.
  114.  
  115.  
  116. +-----------------------------------------------------------------------------+
  117. | 6. Last Words                                                               |
  118. +-----------------------------------------------------------------------------+
  119.     Thanks to Raw Liquid for bringing up this idea.  I've had this thing
  120. laying around for ages, and if it weren't for him, I would never have gotten
  121. around to finishing it up. :)
  122.  
  123.     Otherwise, if you need to reach me for some reason, you can send internet
  124. email to "drew@xinet.com", or leave me a message on Attitude Net, or call my
  125. board: The Silicon Phalanx at 310-575-8567 and apply for access.
  126.  
  127. Peace,
  128. --Drew
  129.  
  130.